home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dbase / dq13.zip / DQ.DOC next >
Text File  |  1989-05-09  |  53KB  |  1,070 lines
  1.   DQ   Quick Database Utility
  2.        written by Richard Dower
  3.        Copyright (c) 1989    All rights reserved.
  4.  
  5.   What is DQ ???
  6.  
  7.   DQ is a utility for getting information about dBASE files.
  8.   All of DQ's activity is read-only and therefore will not alter your
  9.   files in any way.  (This may change if there is enough interest.)
  10.   It allows you to display the structure, browse, count, locate, sum,
  11.   average and goto specific records.  It also allows you to find what 
  12.   each index file in your directory is indexed on and whether that index
  13.   is a possible index for the current database file.   It is primarily 
  14.   for DP professionals who need quick information about dBASE files. 
  15.   DQ gives them information about files and indexes that is usually only
  16.   available by reading the documentation for a specific dBASE application,
  17.   by talking to the original programmer, or using a debugger.
  18.  
  19.   One of the best features is the ability to open two files at once and
  20.   view them both on a split screen.  You can then relate the two files
  21.   through a common character field.  Then, when you move in the first 
  22.   file, you are moved in the second file to the record whose related field
  23.   matches the first file's.  
  24.  
  25.   DQ is small enough that you can usually run it from within your
  26.   word processor or from within dBASE, Foxbase, or DBXL.   Its great for
  27.   finding how indexes are indexed, browsing two files simultaneously, or
  28.   doing quick sums or locates.  
  29.  
  30.   I have found DQ invaluable when writing an application which relates
  31.   two files.  There is no easy way to view the fields from two separate
  32.   databases within dBASE.  DQ not only allows you to view records from
  33.   two different databases simultaneously, but it allows you to relate any
  34.   two matching character fields.  You can quickly browse two files which
  35.   both have a social security field in common, for instance.  Or, you can
  36.   even open the same file in both work areas and by relating a field to
  37.   itself, you can view 40 fields at one time for the same record!  Simply
  38.   select a different set of fields to display in either work area.
  39.  
  40.   Having trouble with an accounting application which uses an ACCOUNTS
  41.   file and a TRANSACTION file related by an account number?  With DQ you
  42.   can easily browse through the data by relating the TRANSACTION file to
  43.   the ACCOUNTS file through the account number.  Then, when you look at
  44.   a transaction, you will see all the information about the account also.
  45.   You can also LOcate for a specific account number or SUM withdrawals,
  46.   deposits, or balances in either database.  The SUM command will also give
  47.   you maximum, minimum, count and average.
  48.  
  49.   Commands Supported so far:
  50.  
  51.     CHECK           check for records with non-printable characters
  52.     COUNT           counts records matching a condition
  53.     DIRECTORY       shows all databases in current index and allows
  54.                     opening of a database by light bar selection
  55.     DIRECTORY INDEX shows all the indexes in the current directory,
  56.                     shows how it is indexed, and whether it is a possible
  57.                     index for the currently opened database.
  58.     FIELDS          show the fields and their definitions
  59.     GOTO            goto a specific record number
  60.     HELP            gives help about any command
  61.     LOCATE          locate a record matching a condition
  62.     NEXT            next locate
  63.     QUIT            quit 
  64.     RELATE          relates two databases by a common field
  65.     SKIP            skip n records forward or back
  66.     STATISTICS      display structure 
  67.     SUM             sums a numeric field on a condition
  68.                     Shows number of records matching condition,
  69.                     sum, average, maximum, and minimum.
  70.     USE             open a database
  71.  
  72.   Functions Supported so far:
  73.     VAL(character field)       used in the SUM command only
  74.     LEFT(field,length)         used in COUNT and LOCATE
  75.     RIGHT(field,length)        used in COUNT and LOCATE
  76.     SUBSTR(field,start,length) used in COUNT and LOCATE
  77.   See the section after the command summaries for a fuller explanation
  78.   of the functions.
  79.  
  80.   All commands in DQ may be truncated to two characters and there is 
  81.   a 10 command buffer that allows you to edit and re-execute previous
  82.   commands.
  83.  
  84.   The current record is always displayed, so there is no need for the
  85.   DISPLAY command.  If there is more than a screen full of fields,
  86.   F2 will toggle between the multiple pages of fields.  
  87.  
  88.   The current record number, whether the current record is deleted,
  89.   total numer of records, and the date the file was last updated are 
  90.   always displayed on the screen.  DQ can also give number of fields,
  91.   field names, field types, file header size and record size. 
  92.  
  93.   You have two work areas to open files within.  Pressing F3 will move
  94.   to the other work area.  You may split the screen so that both work
  95.   areas are showing at the same time by pressing F4.  Pressing F4 again
  96.   will unsplit the screen.  Each work area works exactly as a stand alone
  97.   version of DQ.  The bottom of the screen will let you know which 
  98.   work area has been selected and all windows and messages will appear
  99.   in the active window if the screen is split.
  100.  
  101.   Online Help is available by pressing F1 or entering HELP on the command 
  102.   line.  HELP followed by a command will give help on that specific command.
  103.  
  104.   Version 1.3 
  105.                 1.  Fixed some a positioning bug after a failed LOCATE.
  106.                 2.  Fixed a bug in numeric field compares in conditional
  107.                     statements.  
  108.                      Example:  sum salary salary > 0
  109.                     I mistakenly compiled version 1.2 without a certain
  110.                     header file and what had always worked for me didn't
  111.                     work on the release version!!
  112.                 3.  Added the substr() function.
  113.                     
  114.   Version 1.2   
  115.                 1.  Now has two work areas.  You may have two different 
  116.                     databases open at the same time.
  117.                 2.  Allows splitting the screen to view both open 
  118.                     work areas at the same time.
  119.                 3.  You may relate the database in WORK AREA 1 with the one
  120.                     in WORK AREA 2 on a common field.  Then, whenever you
  121.                     move within the database in area 1, the record is found
  122.                     in area 2 that matches the related field.  You may 
  123.                     relate any character field from area 1 with one in 
  124.                     area 2 as long as they are the same length.  No need
  125.                     to have an index active.  This is great for browsing
  126.                     data that is normally accessed though a dBASE program
  127.                     with SET RELATION command active.  
  128.                 4.  Supports the VAL() function for summing numeric data
  129.                     in character fields.
  130.                 5.  Supports the LEFT() and RIGHT() functions for COUNTing
  131.                     and LOCATEing partial matches within character fields.
  132.  
  133.  
  134.                Shareware is not free software.   If you use and like 
  135.          the program, then the I ask that you register (purchase) the
  136.          program for an amount much smaller than an equivalent commercial
  137.          program ($10.00).  By registering you will receive notice of 
  138.          available upgrades.  Keep in mind that the purchase of a program 
  139.          from a public domain distributor or payment to an online service 
  140.          (such as GENIE) does NOT constitute registration of the program 
  141.          since I do NOT receive any money from that payment.    Shareware
  142.          is NOT public domain software, and continued use of a program 
  143.          carries with it the OBLIGATION to purchase the program.  The free 
  144.          distribution method is intended only as a means of obtaining a 
  145.          copy to evaluate before purchasing.
  146.              DQ is a shareware  program.  If you use it, please REGISTER.
  147.          You will be placed on a mailing list f